home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / embedded / simulato / v2_3_mc6.tz / v2_3_mc6 / readme < prev    next >
Text File  |  1994-05-02  |  6KB  |  114 lines
  1. =============================================================================
  2. =                                                                           =
  3. =               C O M P U T E R    O R G A N I Z A T I O N                  =
  4. =                                                                           =
  5. =                      A N D   T H E   M C 6 8 0 0 0                        =
  6. =                                                                           =
  7. =                                                                           =
  8. =                          By Livadas and Ward                              =
  9. =                                        =
  10. =                    Copyright (C) 1993 Prentice Hall                       =
  11. =                                                                           =
  12. =============================================================================
  13.  
  14. This distribution contains the software to accompany the text.  The
  15. software is available free of charge in executable form only.  The
  16. authors give permission for the software to be copied without
  17. modification.  The software is provided "as is" without warranty of
  18. any kind, express or implied, including warranties of merchantability
  19. or fitness for a particular purpose.
  20.  
  21. This distribution contains programs executable on your system.  With
  22. the entire suite of software included, it is possible to conduct
  23. laboratory work for the course without any hardware other than the
  24. target computer.  Versions are currently prepared for the IBM PC and
  25. Sun Unix workstations popular at many universities.  The following
  26. programs are included.  Executables should be placed
  27. in a directory included in your PATH variable.
  28.  
  29. SIM68        -Simulates the SIM68 hypothetical computer with limited
  30.          memory, registers, and opcodes (only 15 operations
  31.          are realized).  Has an interface similar to the tutor
  32.          board.  Loads files with the object file format as
  33.          described in the textbook (.ld).  The following switch
  34.          is useful: -s reads S-record files instead of .ld files.
  35.          NOTE: Appendix A and B incorrectly state that SIM68
  36.          reads S-record files as the default.  Also note that the
  37.                  simulator will produce a memory dump that writes to a file
  38.                  dump.dat if the trap command is used to perfom a memory dump.
  39.                  This practice is not advised, however.  The file will contain
  40.                  _all_ of the conents of memory (16k) which is a cumbersome
  41.                  file to store and to read through.  For most applications,
  42.                  the md command executed from within the simulator will
  43.                  provide all of the necessary information.
  44.  
  45.  
  46. ASM68        -Assembler for SIM68 providing limited functionality.
  47.          Input files are text and have the extension .asm.
  48.          Output is the object file format as described in the
  49.          textbook (.ld) for use with SIM68. The following switches
  50.          are useful: -l turns on listing, -s generates S-record
  51.          files instead of .ld files. NOTE: Appendix A and
  52.          B incorrectly state that ASM68 generates S-record
  53.          files as the default.
  54.  
  55. SIM68K        -Full fledged ECB simulator.  Closely emulates primary
  56.          operations of the Educational Computer Board.  Use LO
  57.          Tutor command to load in S-records (.s) and ST to
  58.          store memory regions in S-record format.
  59.  
  60. XSIM68K        -(Sun version only) A graphical user interface to SIM68K
  61.          for use on Sun platforms supporting the X Windows system.
  62.          Use the "load" button and directory subwindow to load
  63.          S-record (.s) input files.  The "store" button stores
  64.          memory regions in S-record format.         
  65.  
  66. ASM68K        -Full featured macro, relocateable assembler for the
  67.          Motorola 68000 microprocessor.  Input files are text
  68.          and have extension .asm.  Output is .s for S-records,
  69.          .lst for listing files and .o for relocateable object
  70.          modules.  The following switches are useful: -l turns
  71.          on listing, -r causes generation of relocateable
  72.          code.
  73.  
  74. LINK        -Links relocatable object modules together at loading
  75.          origin specified in command line.  Input files are
  76.          all relocateable object modules with file extension
  77.          .o, while output is an S-record (.s) file.
  78.  
  79. TEXTTOS        -Simple utility for translating ASCII text files into
  80.          S-record format usable by the Tutor board and the
  81.          simulator.  Output files have .s and .lst file
  82.          extensions.
  83.  
  84. STOTEXT        -Simple utility for translating S-record files into
  85.          ASCII text.  Input file must have .s extension,
  86.          output file has .out extension.
  87.  
  88. MKLOAD        -Turns textfiles consisting of binary opcodes and
  89.          comments (denoted by a semicolon) into the object
  90.          file format as described in the textbook (.ld) for
  91.                  use with SIM68. The following switch is useful: -s
  92.          generates S-record files instead of .ld files. NOTE:
  93.          Appendix A and B incorrectly state that MKLOAD
  94.          generates S-record files as the default. 
  95.  
  96. In addition there is a directory containing test files exercising the
  97. system.  Included is "readme.tst" with more information and the following
  98. set of useful routines:
  99.  
  100. SAMPLES.ASM    -A set of subroutines written in 68000 assembly code.
  101.          Performs vital operations such as output a string,
  102.          input a string, clearing the screen, allocating
  103.          dynamic memory, and others.  Just include this file
  104.          in any assembly program that needs these routines
  105.          using the "include" directive.
  106.  
  107.  
  108. If you have any problems with the software, please send e-mail to:
  109.  
  110.   pel@cis.ufl.edu
  111.  
  112. We can tell you if a newer version of the software has come out, or, if
  113. not, we can set about fixing the error.
  114.